home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-5625 / hpcd051b / hpcdtopp.1 next >
Text File  |  1996-03-10  |  8KB  |  208 lines
  1. hpcdtoppm(1)             USER COMMANDS               hpcdtoppm(1)
  2.  
  3. NAME
  4.      hpcdtoppm v0.5 pl1 - convert a Photo-CD file into a portable
  5.      pixmap
  6.  
  7. SYNOPSIS
  8.      hpcdtoppm [options] pcd-file [ppm-file]
  9.  
  10. DESCRIPTION
  11.      Decodes a Photo-CD Image file or Overview file.  Image files
  12.      you  can  find  on the Photo-CD in photo_cd/images, they are
  13.      named as "imgnnnn.pcd", where nnnn is a 4-digit-number.  The
  14.      Overview  file  is at photo_cd/overview.pcd . If there is no
  15.      output filename given, output will  be  printed  to  stdout.
  16.      hpcdtoppm  stands for "Hadmut's pcdtoppm" to make it distin-
  17.      guishable in case someone else is building  the  same  thing
  18.      and calling it pcdtoppm. Call hpcdtoppm without arguments to
  19.      see the defaults values. If pcd-file is  "-",  the  Photo-CD
  20.      file is read from stdin.
  21.  
  22. OPTIONS
  23.      -x   Overskip Mode.  Works  on  Base/16,  Base/4,  Base  and
  24.           4Base. In Photo-CD images the luma channel is stored in
  25.           full resolution, the two chroma channels are stored  in
  26.           half  resolution  only and have to be interpolated.  In
  27.           the Overskip Mode  the  chroma  channels  of  the  next
  28.           higher  resolution  are taken instead of interpolating.
  29.           To see the difference, generate one ppm  with  and  one
  30.           ppm  without  this  flag.  Use pnmarith to generate the
  31.           difference image of these two images. Call ppmhist  for
  32.           this  difference  or  show  it with xv (push the HistEq
  33.           button in the color editor).
  34.  
  35.      -s   Apply simple sharpness-operator on the Luma-channel.
  36.  
  37.      -d   Do  not  show  the  complete  image,   but   only   the
  38.           decompressed  difference.   It  works only on the 4Base
  39.           and the 16Base resolution. It does not have any  deeper
  40.           sense, but it was simple to implement and it shows what
  41.           causes different sizes of image files.
  42.  
  43.      -i   Give some information from the fileheader to stderr. It
  44.           works   only  for  Image  files.  (It  is  not  working
  45.           correctly, just printing some strings.)
  46.  
  47.      -m   Show the phases of decoding to stderr.
  48.  
  49.      -crop
  50.           Try to cut off  the  black  frame  which  is  sometimes
  51.           scanned at the image borders. The image size shrinks.
  52.  
  53.      -pos Print the file relative start position of the data  for
  54.           the current resolution.
  55.  
  56.      -rep Try to jump over reading errors in Huffman code.
  57.  
  58.      -n   Don't rotate the image.
  59.  
  60.      -r   Rotate the picture clockwise for portraits.
  61.  
  62.      -l   Rotate the picture counter-clockwise for portraits.
  63.  
  64.      -a   Try to find out  the  image  orientation  byself.  This
  65.           doesn't work for overview files yet. It is very experi-
  66.           mental and depends on one byte. Please tell  me  if  it
  67.           doesn't work.
  68.  
  69.      -vert
  70.           Vertical flip.
  71.  
  72.      -hori
  73.           Horizontal flip.
  74.  
  75.      -S h v
  76.           Cut out subrectangle with boundaries h (longer side  of
  77.           the  image)  and  v  (shorter side). h and v are of the
  78.           form a-b ( cut from a to b ) or a+b ( offset a,  length
  79.           b). a and b are integer (pixels) or float [0.0 ... 1.0]
  80.           relative to the length of the side.
  81.  
  82.      -ppm Write rgb image in ppm-format.
  83.  
  84.      -pgm Write grayscale image in pgm-format.
  85.  
  86.      -ycc Write ycc image in ppm-format.
  87.  
  88.      -ps  Write rgb image in postscript.
  89.  
  90.      -eps Write rgb image in encapsulated postscript.
  91.  
  92.      -psg Write grayscale image in postscript.
  93.  
  94.      -epsg
  95.           Write grayscale image in encapsulated postscript.
  96.  
  97.      -psd Write a Floyd-Steinberg dithered image  in  postscript.
  98.           See the Postscript section below.
  99.  
  100.      -epsd
  101.           Write a Floyd-Steinberg dithered image in  encapsulated
  102.           postscript.  See the Postscript section below.
  103.  
  104.      -pl f
  105.           Set left position of Postscript image to f.
  106.  
  107.      -pb f
  108.           Set bottom position of Postscript image to f.
  109.  
  110.      -pw f
  111.           Set width of Postscript image to f.
  112.  
  113.      -ph f
  114.           Set height of Postscript image to f.
  115.  
  116.      -dpi f
  117.           Set printer resolution for dithered postscript  images.
  118.           See the Postscript section below.
  119.  
  120.      -fak f
  121.           Sets a scaling factor for dithered  postscript  images.
  122.           See the Postscript section below.
  123.  
  124.      -c0  Don't correct the image.
  125.  
  126.      -c-  Do a correction (darker). Hardware and taste dependend.
  127.  
  128.      -c+  Do a correction (brighter). Hardware and  taste  depen-
  129.           dend.
  130.  
  131.      -1 | -Base/16 | -128x192
  132.           Extract the Base/16 size picture (size 128x192 pixels).
  133.           Note that you can only give one size option.
  134.  
  135.      -2 | -Base/4 | -256x384
  136.           Extract the Base/4 size picture.
  137.  
  138.      -3 | -Base | -512x768
  139.           Extract the Base size picture.
  140.  
  141.      -4 | -4Base | -1024x1536
  142.           Extract the 4Base size picture.
  143.  
  144.      -5 | -16Base | -2048x3072
  145.           Extract the 16Base size picture.
  146.  
  147.      -0 | -Overview | -O
  148.           Extract  all  pictures  from  an   Overview   file.   A
  149.           ppmfilename  must be given. If the given name is "foo",
  150.           the files are named "foonnnn", where nnnn is a  4-digit
  151.           number.   Since they are stored in Base/16 format, they
  152.           are extracted in this format.
  153.  
  154.      -C d s
  155.           Extract  all  pictures  from  an   Overview   file.   A
  156.           ppmfilename  must be given. If the given name is "foo",
  157.           the files are named "foonnnn", where nnnn is a  4-digit
  158.           number.   Since they are stored in Base/16 format, they
  159.           are extracted in this format. s is one of "n", "l"  and
  160.           "r" and determines the orientation of the contact sheet
  161.           image.
  162.  
  163. POSTSCRIPT OUTPUT
  164.      For postscript output ( ps, eps, psg, epsg, psd, epsg )  you
  165.      can  choose  parameters  for the resolution and placement on
  166.      the paper.  The default values are used if none of the  fol-
  167.      lowing options is given.
  168.  
  169.      The position of  the  image  within  the  paper  (down  left
  170.      corner) is changed with the -pl and -pb option for all reso-
  171.      lutions. The unit is 1/72 inch.
  172.  
  173.      For color and grayscale postscript you can change the  image
  174.      size  with  the  -pw and -ph option (1/72 inch). Every image
  175.      pixel is mapped onto one postscript pixel.
  176.  
  177.      For dithered postscript (-psd and  -epsd)  there  are  three
  178.      options,  the  image size (-pw and -ph), the printer resolu-
  179.      tion (-dpi) and a scaling factor (-fak). Since these  values
  180.      depend  from  each  other, you can not give more than two of
  181.      these options. You should play with these options to get the
  182.      results  you like. You will get pretty images if you use the
  183.      -dpi and the -pw/-ph options together. Even if you  use  the
  184.      default  values,  the result will not be the same as without
  185.      options.
  186.  
  187. BUGS
  188.      hpcdtoppm seems to  ignore  the  read  protection.  :-)  The
  189.      informations  i  have  are  quite vague and this program was
  190.      developed by staring at the hex-dumps and the famous  trial-
  191.      and-error-method. If anything doesn't work, please send me a
  192.      report and perhaps you could try to find out, why it doesn't
  193.      work.
  194.  
  195. SEE ALSO
  196.      ppm(5), ppmquant(1), ppmtopgm(1),  ppmhist(1),  pnmarith(1),
  197.      ppmtorgb3(1), xv(1)
  198.  
  199. AUTHOR
  200.      Copyright    (c)    1992,    1993    by    Hadmut    Danisch
  201.      (danisch@ira.uka.de).  Permission to use and distribute this
  202.      software and its documentation  for  noncommercial  use  and
  203.      without fee is hereby granted, provided that the above copy-
  204.      right notice appear in all copies and that both  that  copy-
  205.      right notice and this permission notice appear in supporting
  206.      documentation. It is not allowed to sell  this  software  in
  207.      any way. This software is not public domain.
  208.